www.gusucode.com > FavShop网店系统源码程序 > FavShop网店系统 1.0/upload/cake/libs/file.php
<?php
/* SVN FILE: $Id: file.php 6311 2008-01-02 06:33:52Z phpnut $ */
/**
* Convenience class for reading, writing and appending to files.
*
* PHP versions 4 and 5
*
* CakePHP(tm) : Rapid Development Framework <http://www.cakephp.org/>
* Copyright 2005-2008, Cake Software Foundation, Inc.
* 1785 E. Sahara Avenue, Suite 490-204
* Las Vegas, Nevada 89104
*
* Licensed under The MIT License
* Redistributions of files must retain the above copyright notice.
*
* @filesource
* @copyright Copyright 2005-2008, Cake Software Foundation, Inc.
* @link http://www.cakefoundation.org/projects/info/cakephp CakePHP(tm) Project
* @package cake
* @subpackage cake.cake.libs
* @since CakePHP(tm) v 0.2.9
* @version $Revision: 6311 $
* @modifiedby $LastChangedBy: phpnut $
* @lastmodified $Date: 2008-01-02 00:33:52 -0600 (Wed, 02 Jan 2008) $
* @license http://www.opensource.org/licenses/mit-license.php The MIT License
*/
/**
* Included libraries.
*
*/
if (!class_exists('Object')) {
uses ('object');
}
if (!class_exists('Folder')) {
uses ('folder');
}
/**
* Convenience class for reading, writing and appending to files.
*
* @package cake
* @subpackage cake.cake.libs
*/
class File extends Object {
/**
* Folder object of the File
*
* @var object
* @access public
*/
var $Folder = null;
/**
* Filename
*
* @var string
* @access public
*/
var $name = null;
/**
* file info
*
* @var string
* @access public
*/
var $info = array();
/**
* Holds the file handler resource if the file is opened
*
* @var resource
* @access public
*/
var $handle = null;
/**
* enable locking for file reading and writing
*
* @var boolean
* @access public
*/
var $lock = null;
/**
* Constructor
*
* @param string $path Path to file
* @param boolean $create Create file if it does not exist (if true)
* @param integer $mode Mode to apply to the folder holding the file
* @access private
*/
function __construct($path, $create = false, $mode = 0755) {
parent::__construct();
$this->Folder =& new Folder(dirname($path), $create, $mode);
if (!is_dir($path)) {
$this->name = basename($path);
}
if (!$this->exists()) {
if ($create === true) {
if ($this->safe($path) && $this->create() === false) {
return false;
}
} else {
return false;
}
}
}
/**
* Closes the current file if it is opened
*
* @access private
*/
function __destruct() {
$this->close();
}
/**
* Creates the File.
*
* @return boolean Success
* @access public
*/
function create() {
$dir = $this->Folder->pwd();
if (is_dir($dir) && is_writable($dir) && !$this->exists()) {
if (touch($this->pwd())) {
return true;
}
}
return false;
}
/**
* Opens the current file with a given $mode
*
* @param string $mode A valid 'fopen' mode string (r|w|a ...)
* @param boolean $force If true then the file will be re-opened even if its already opened, otherwise it won't
* @return boolean True on success, false on failure
* @access public
*/
function open($mode = 'r', $force = false) {
if (!$force && is_resource($this->handle)) {
return true;
}
if ($this->exists() === false) {
if ($this->create() === false) {
return false;
}
}
$this->handle = fopen($this->pwd(), $mode);
if (is_resource($this->handle)) {
return true;
}
return false;
}
/**
* Return the contents of this File as a string.
*
* @param string $bytes where to start
* @param string $mode
* @param boolean $force If true then the file will be re-opened even if its already opened, otherwise it won't
* @return mixed string on success, false on failure
* @access public
*/
function read($bytes = false, $mode = 'rb', $force = false) {
$success = false;
if ($this->lock !== null) {
if (flock($this->handle, LOCK_SH) === false) {
return false;
}
}
if ($bytes === false) {
$success = file_get_contents($this->pwd());
} elseif ($this->open($mode, $force) === true) {
if (is_int($bytes)) {
$success = fread($this->handle, $bytes);
} else {
$data = '';
while (!feof($this->handle)) {
$data .= fgets($this->handle, 4096);
}
$success = trim($data);
}
}
if ($this->lock !== null) {
flock($this->handle, LOCK_UN);
}
return $success;
}
/**
* Sets or gets the offset for the currently opened file.
*
* @param mixed $offset The $offset in bytes to seek. If set to false then the current offset is returned.
* @param integer $seek PHP Constant SEEK_SET | SEEK_CUR | SEEK_END determining what the $offset is relative to
* @return mixed True on success, false on failure (set mode), false on failure or integer offset on success (get mode)
* @access public
*/
function offset($offset = false, $seek = SEEK_SET) {
if ($offset === false) {
if (is_resource($this->handle)) {
return ftell($this->handle);
}
} elseif ($this->open() === true) {
return fseek($this->handle, $offset, $seek) === 0;
}
return false;
}
/**
* Prepares a ascii string for writing
* fixes line endings
*
* @param string $data Data to prepare for writing.
* @return string
* @access public
*/
function prepare($data) {
$lineBreak = "\n";
if (substr(PHP_OS,0,3) == "WIN") {
$lineBreak = "\r\n";
}
return strtr($data, array("\r\n" => $lineBreak, "\n" => $lineBreak, "\r" => $lineBreak));
}
/**
* Write given data to this File.
*
* @param string $data Data to write to this File.
* @param string $mode Mode of writing. {@link http://php.net/fwrite See fwrite()}.
* @param string $force force the file to open
* @return boolean Success
* @access public
*/
function write($data, $mode = 'w', $force = false) {
$success = false;
if ($this->open($mode, $force) === true) {
if($this->lock !== null) {
if(flock($this->handle, LOCK_EX) === false) {
return false;
}
}
if (fwrite($this->handle, $data) !== false) {
$success = true;
}
if($this->lock !== null) {
flock($this->handle, LOCK_UN);
}
}
return $success;
}
/**
* Append given data string to this File.
*
* @param string $data Data to write
* @param string $force force the file to open
* @return boolean Success
* @access public
*/
function append($data, $force = false) {
return $this->write($data, 'a', $force);
}
/**
* Closes the current file if it is opened.
*
* @return boolean True if closing was successful or file was already closed, otherwise false
* @access public
*/
function close() {
if (!is_resource($this->handle)) {
return true;
}
return fclose($this->handle);
}
/**
* Deletes the File.
*
* @return boolean Success
* @access public
*/
function delete() {
if ($this->exists()) {
return unlink($this->pwd());
}
return false;
}
/**
* Returns the File extension.
*
* @return string The File extension
* @access public
*/
function info() {
if ($this->info == null) {
$this->info = pathinfo($this->pwd());
}
if (!isset($this->info['filename'])) {
$this->info['filename'] = $this->name();
}
return $this->info;
}
/**
* Returns the File extension.
*
* @return string The File extension
* @access public
*/
function ext() {
if ($this->info == null) {
$this->info();
}
if (isset($this->info['extension'])) {
return $this->info['extension'];
}
return false;
}
/**
* Returns the File name without extension.
*
* @return string The File name without extension.
* @access public
*/
function name() {
if ($this->info == null) {
$this->info();
}
if (isset($this->info['extension'])) {
return basename($this->name, '.'.$this->info['extension']);
} elseif ($this->name) {
return $this->name;
}
return false;
}
/**
* makes filename safe for saving
*
* @param string $name the name of the file to make safe if different from $this->name
* @return string $ext the extension of the file
* @access public
*/
function safe($name = null, $ext = null) {
if (!$name) {
$name = $this->name;
}
if (!$ext) {
$ext = $this->ext();
}
return preg_replace( "/[^\w\.-]+/", "_", basename($name, $ext));
}
/**
* Get md5 Checksum of file with previous check of Filesize
*
* @param mixed $maxsize in MB or true to force
* @return string md5 Checksum {@link http://php.net/md5_file See md5_file()}
* @access public
*/
function md5($maxsize = 5) {
if ($maxsize === true) {
return md5_file($this->pwd());
} else {
$size = $this->size();
if ($size && $size < ($maxsize * 1024) * 1024) {
return md5_file($this->pwd());
}
}
return false;
}
/**
* Returns the full path of the File.
*
* @return string Full path to file
* @access public
*/
function pwd() {
return $this->Folder->slashTerm($this->Folder->pwd()) . $this->name;
}
/**
* Returns true if the File exists.
*
* @return boolean true if it exists, false otherwise
* @access public
*/
function exists() {
$exists = (file_exists($this->pwd()) && is_file($this->pwd()));
return $exists;
}
/**
* Returns the "chmod" (permissions) of the File.
*
* @return string Permissions for the file
* @access public
*/
function perms() {
if ($this->exists()) {
return substr(sprintf('%o', fileperms($this->pwd())), -4);
}
return false;
}
/**
* Returns the Filesize, either in bytes or in human-readable format.
*
* @param boolean $humanReadeble Data to write to this File.
* @return string|int filesize as int or as a human-readable string
* @access public
*/
function size() {
if ($this->exists()) {
return filesize($this->pwd());
}
return false;
}
/**
* Returns true if the File is writable.
*
* @return boolean true if its writable, false otherwise
* @access public
*/
function writable() {
return is_writable($this->pwd());
}
/**
* Returns true if the File is executable.
*
* @return boolean true if its executable, false otherwise
* @access public
*/
function executable() {
return is_executable($this->pwd());
}
/**
* Returns true if the File is readable.
*
* @return boolean true if file is readable, false otherwise
* @access public
*/
function readable() {
return is_readable($this->pwd());
}
/**
* Returns the File's owner.
*
* @return integer the Fileowner
*/
function owner() {
if ($this->exists()) {
return fileowner($this->pwd());
}
return false;
}
/**
* Returns the File group.
*
* @return integer the Filegroup
* @access public
*/
function group() {
if ($this->exists()) {
return filegroup($this->pwd());
}
return false;
}
/**
* Returns last access time.
*
* @return integer timestamp Timestamp of last access time
* @access public
*/
function lastAccess() {
if ($this->exists()) {
return fileatime($this->pwd());
}
return false;
}
/**
* Returns last modified time.
*
* @return integer timestamp Timestamp of last modification
* @access public
*/
function lastChange() {
if ($this->exists()) {
return filemtime($this->pwd());
}
return false;
}
/**
* Returns the current folder.
*
* @return Folder Current folder
* @access public
*/
function &Folder() {
return $this->Folder;
}
/* Deprecated methods */
/**
* @deprecated
* @see File::pwd
*/
function getFullPath() {
trigger_error('Deprecated: Use File::pwd() instead.', E_USER_WARNING);
return $this->pwd();
}
/**
* @deprecated
* @see File::name
*/
function getName() {
trigger_error('Deprecated: Use File::name() instead.', E_USER_WARNING);
return $this->name;
}
/**
* @deprecated
* @see File::name()
*/
function filename() {
trigger_error('Deprecated: Use File::name() instead.', E_USER_WARNING);
return $this->name();
}
/**
* @deprecated
* @see File::ext()
*/
function getExt() {
trigger_error('Deprecated: Use File::ext() instead.', E_USER_WARNING);
return $this->ext();
}
/**
* @deprecated
* @see File::md5()
*/
function getMd5() {
trigger_error('Deprecated: Use File::md5() instead.', E_USER_WARNING);
return $this->md5();
}
/**
* @deprecated
* @see File::size()
*/
function getSize() {
trigger_error('Deprecated: Use File::size() instead.', E_USER_WARNING);
return $this->size();
}
/**
* @deprecated
* @see File::owner()
*/
function getOwner() {
trigger_error('Deprecated: Use File::owner() instead.', E_USER_WARNING);
return $this->owner();
}
/**
* @deprecated
* @see File::group()
*/
function getGroup() {
trigger_error('Deprecated: Use File::group() instead.', E_USER_WARNING);
return $this->group();
}
/**
* @deprecated
* @see File::perms()
*/
function getChmod() {
trigger_error('Deprecated: Use File::perms() instead.', E_USER_WARNING);
return $this->perms();
}
/**
* @deprecated
* @see File::Folder()
*/
function getFolder() {
trigger_error('Deprecated: Use File::Folder() instead.', E_USER_WARNING);
return $this->Folder();
}
}
?>